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Preface 

This dcxument provides the following information: 

• features 

• installation information 

• related documentation 

• problem descriptions and fixes and known limitations 

Note: The software code printed in the release notes title indicates the software product 
version at the time of release. Some product and operating system changes do not 
requi re changes to documentation; therefore, do not expect a one-to-one correspondence 
between these changes and release notes updates. 

Latest printing: December, 2000 

This document resides online in the following locations: 

• /opt/aCC/newconfig/Rel Notes/ACXX.release.notes 

To print this file, use an ip command I ike the foil owing: 

Ip -dprinter_name /opt/aCC/newconfig/RelNotes/ACXX.release.notes 

• http://www.hp.com/go/c-l-l- 

Useyour browser to access the H P aC-H-Home Page and look at the documentation. 

Problem Reporting If you have any problems with the software or documentation, please contact your local 
Hewlett-Packard Sales Office or Customer Service Center. 
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Features 


1 Features 


This chapter summarizes the features inciuded in this version of the HP aC++compiier. 
Features introduced in prior reiease versions are aisoiisted and grouped by thecompiier 
version number. 

Thecompiier supports much of the i SO/ i EC 14882 Standard for the C++Programming 
Language (the internationai standard for C++). 


Chapter 1 


5 



Features 

New and Changed Features 


New and Changed Features 

New features in H P aC++version A.03.27 are listed below. They apply to the HP-UX 
11.x and operating systems. 

HP aC-H-provides a variety of performance related options, in addition to the options 
described in these release notes. Seethe H P aC-H-Online Programmer's 
GuidePerformancesection for full documentation (unless otherwise noted below). 
Chapter 3 of these release notes provides access instructions to the guide. 

Highlights 

• Rogue Wave standard C-H-Library 2.2.1 

• Common Migration Problem when using the-AA Option 

• Transitioning from the Prior to the New Standard C-H-Library 

• Online Documentation for Standard C-H-Library 2.2.1 

• man Pages for Standard C-H-Library 2.2.1 

• Incremental Linking in 64-bit Mode 

• Linker Patch Requirements for 11.x and Hi 

More Details 

• The Rogue Wave Standard C-H-Library 2.2.1 (Iibstd_v2) is now bundled with H P 
aC-H-. This library includes the standard iostream library and has namespace std 
enabled. 

To use the new library, you must specify the-AA command line option. Note, the 
following: 

— The -fA option is not a supported with -AA and may give various link or run-time 
errors. 

— The Rogue Wave Tools.h-H-Version 7.0.6 library cannot be used with -AA. 

— The prior library (Rogue Wave Standard C-H-Library 1.2.1) is the default. 

— The The prior libraries (Rogue Wave Standard C-H-Library 1.2.1 and Rogue 
Wave Tools.h-H-Version 7.0.6) are not compatible with the 2.2.1 library. Code 
compiled without -AA is incompatible with codecompiled with -AA. 

• The following example shows a common problem when using the-AA option. The 
result of using the new overloads of strchr (on a const char*) is now a const char*. 
And Error 440 results if "p" is not declared as a const char*. 

#include <string.h> 
int main() { 

char *p = strchr("abc", 'c'); 

} 

$ aCC -c strchr.c 
$ aCC -c strchr.c -AA 
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Error 440: "strchr.c", line 3 # Cannot initialize 'char *' with 
'const char char *p = strchr("abc", 'c'); 

• Transitioning from the Prior to the New Standard C++Library 

— Source Code Changes 

Since the new Standard C++Library (Iibstd_v2) includes the new iostream 
library and has namespacestd enabled, significant changes may be required in 
your source code. For example, the following program will no longer compile: 

tinclude <iostream> // ported from <iostream.h> 

int main() { 

cout << "Hello, World" << endl; 
t 

Because both cout and endl are now in namespace std, they must be referenced 
as std::cout and std::endl. Alternatively, using declarations or using directives 
can be added to your code to make them visi ble outside of the namespace std 
scope. The following is correct: 

tinclude <iostream> 
int main() { 

std::cout << "Hello, World" << std::endl; 

} 

— iostream_compat Directory 

To help with code transition tothe new C++standard, an iostream_compat 
directory is provided. It contains some header files that are just wrappers.You 
can include files in the iostream_compat directory even when specifying the-AA 
option, to make symbols I ike cout visible in global scope. 

For example, <ostream.h>is in iostream_compat, and it includes the new 
<ostream>header followed by a using directive (using namespace std). So the 
following program will also compile, with warning 890: 

tinclude <iostream> 
int main() { 

cout << "Hello, World" << endl; 

} 

To turn off the warning, specify the+W890 command line option. 


NOTE I n general, you are encouraged to use header names as specified in the C++ 

standard. We do not guarantee the inclusion of non-standard compliant headers 
in our future releases. 


See the C-F+international standard for detailed language rules 
— Threads 

As with prior compiler releases, one version of Iibstd_v2 is provided for use with 
both threaded and non-threaded code. To compile threaded applications, macro 
-D_RWSTD_MULTI_THREAD must be used. -D_TH READ_SAFE is no longer 
needed. 

Refer tothe HP aC-F+OnlineProgramma'sGuide section on Threads for more 
information. (See Chapter 3 of these release notes for access instructions.) 
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— Limitations 

USL's Standard Components Library (lib++.a) is not and will not be available 
with -AA. 

• Documentation for Rogue Wave Standard C++Library 2.2.1 is provided online in 
HTM L format. Refer to Chapter 3 of these release notes. 

• Manual pages are located at /opt/aCC/shar^man/man3.Z. To insure that you invoke 
a man page for the library in which you are interested, specify the appropriate 
section 3 sub-section. For example, to find the man page for the copy command: 

man 3n copy # finds the new Standard C++ Library (libstd_v2) 

man 3f copy # finds the old Standard C++ Library (libstd) 

man 3s copy # finds the Standard Components version 


• I n the edit-compile-link-debug development cycle, link time is a 
significant component. With incremental linking, any unchanged 
object files can be reused without being reprocessed. I ncremental 
linking allows you to insert object code into an output file (executable 
or shared library) that you created earlier, without relinking any 
unmodified object files. Time required to relink after the initial 
incremental link depends on the number of modules you modify. 

To use incremental linking, specify the -Fild option on the aCC command line. If the 
output file does not already exist or if it was created without the -Fild option, the 
linker performs an initial incremental link. The output file produced is suitablefor 
subsequent incremental links. 

The -Fild option is valid in 64-bit mode for both executable and shared library links. 
The -Fild option is not valid for relocatable links, options (or tools) that strip the 
output module, and with some optimization options. 

I n certain situations (for example, when internal padding space is exhausted), the 
incremental linker must perform an initial incremental link. You can avoid such 
unexpected initial incremental links by periodically rebuilding the output filewith 
the -Fildrelink option. 

You can debug the resulting executable or shared library produced by the 
incremental linker using the WDB debugger with incremental-Iinking support. 

See the Online Linker and Libraries User's Guide (Id -Fhelp) and ld(l) for more 
information.Also refer to the H P aC-F-FOnline Programmer's Guide (aCC -Fhelp). 

• For releases prior to HP-UX Hi, the latest linker patch is needed in order to use the 
-Fobjdebug option and to build shared libraries.1 ncremental linking is only available 
on H P-UX Hi or a subsequent patch.See these release notes. Chapter 2, Current 
Linker Required, for details. 
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Version A.03.25 Features 

Features introduced in the prior release, H P aC++version A.03.25, are listed below. 
They apply to H P-UX 11.x operating systems. 

The HP aC++OnlineProgramma's Guide cental ns full documentation. (See Chapter 3 
of these release notes for access instructions.). 

Highlights 

• Linker Patch (PHSS_19866) required for 4objdebug and shared libraries 

• -FESplabel option (run-time performance) 

• -Hnline_level [i]n option (run-timeperformance) 

• -fast option (run-time performance and porting to H P-UX) 

• Fix and continue debugging (build-time performance) 

• HP Pac and Blink Link no longer bundled with HP aC-F-Fon HP-UX 11.x. 

• -FOfailsafeoption new defaults (run-time performance) 

• -FDD[data_model] option (run-time performance) 

• -FESlit option new default (run-time performance) 

NOTE: MAY RESULT IN SIGNAL lORUN-TIME ABORTS IN ILL-FORMED 
PROGRAMS. 

• Function Try Blocks as defined in the C-F-FStandard 

• Assert and #jnassert preprocessor directives 

• enum x {xl, }; trailing comma now generates Warning 921 

• -Fm[d] and -fM [d] options have changed behavior 

• -Fuc option for porting to HP-UX 

• Predefined string variable identifiers for function names (porting/debug) 

• Macros having a variable number of arguments (porting) 

• Alignment of long double data type in 64-bit mode changed to 16-bytes 

• -D_HPACC_THREAD_SAFE_RB_TREE macro insures thread safety 

• Preview online documentation to become familiar with the upcoming Standard C-F-F 
Library 2.x 

• Preview man pages in preparation for upcoming Standard C-f-fL ibrary 2.x 

More Details 

• The latest linker patch (PHSS_19866) is needed in order to use the -Fobjdebug option 
and to build shared libraries. See these release notes. Chapter 2, Current Linker 
Required, for details. 
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NOTE 


The -FESplabel option affects how function pointers are dereferenced in generated 
code. Using this option can improve run-time performance at the expensive of a 
slight increase in code size for every call. The option can only be used: 

— in an environment where there are shared libraries 

— with -I-DA2.0 or -I-DA2.0W 

The -Finlinejevel [i]n option does implicit inlining of small functions that are not 
explicitly tagged with the inline keyword. Such inlining happens in addition to 
explicitly inlined functions. As before, 4d and -Hnline_level 0 turn off all inlining, 
including implicit inlining. 

The -fast option selects a combination of compilation options for optimum execution 
speed for reasonable build times. Currently chosen options are: 

— 402,-fOlibcalls, and- fFPD 

— I f 4ooeh occurs before -fast, then -fOentrysched is also added. 

Fix and continue debugging is now supported with HP aC4-F. Fix and continue 
speeds up the edit-com pi I e-debug cycle by allowing you to make changes to a 
program from within the WDB debugger and continue debugging without having to 
exit the debugger and rebuild. For details about how to use fix and conti nue from 
either the WDB GUI interface or the WDB command line, see the WDB debugger 
release notes at: 

opt/langtools/wdb/doc/html/wdb/C/WDBrln.html 

HP Pac and Link are no longer bundled with HP aC-F-Fon H P-UX ll.x.The H P 
CXperf performance analysis tool is availablefor download. Refer to: 

http:// WWW .hp.com/esy/lang/tools/Performance/index.html 

There are new default settings for the -FOfailsafe option. Refer tothe Options section 
of the HP aC-F-FOnlineProgramma's Guide 

The -FDD[data_model] option specifies the compiler data model as either 32-bit 
(ILP32) or 64-bit (LP64). 

The -FFP[flags] option specifies how the run-time environment for floating-point 
operations should beinitialized at program start up.Thedefault isthat all behaviors 
are disabled. See ld(l) for specific flag values. To dynamically change these settings 
at run time, refer tofesetenv(3M). 

By default, string literal data now resides in read-only memory rather than 
read-write memory. This new default may result in improved run-time performance, 
because read-only memory is shared. The -fE SI it command line option can be used to 
explicitly specify this behavior. -FESnolit reverts to storing string literal data in 
read-write memory. 

NOTE:THIS NEWDEFAULT OPTION MAY CAUSE PROGRAM S TO ABORT 
WITH SIGNAL lOAT RUN-TIME. 

String literals (quoted character strings) are typed as "const char[]" and programs 
that attempt to modify string literal data are violating the semantics of this "const" 
type.Modifying string literal data at the source level translates to writing data into 
read-only memory at runtime and will result in the process receiving a signal 10 (bus 
error). Below is an example of such a program: 
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void f (char *s) { // Warning 829: const char* -> char* 
s[0] = 'S'; // abort: write into read-only memory 

) 

int main() { 

f("string literal"); 
return 0; 

} 

Programs that attempt to write into a string literal's read-only memory will trigger 
warnings and errors at compile-time. Fixing the program's compile-time errors and 
warni ngs has the benefit of enabi i ng the use of -fE SI it, thus taki ng advantage of 
improved run-time efficiency and improving the application's portability. 

The following code generates the compile-time errors shown below: 

int main() { 

const char *p = "quoted string"; 

char* c=p; // Error 440 

void main2 () { 

const char *p 
char* c; 
c=p; 

aCC -c foo.C 

Error 440: "foo.C", line 3 # Cannot initialize 'char *' with 
'const char *'. char* c=p; 

Error 203: "foo.C", line 8 # Cannot assign 'char *' with ' 
const char *'. c=p; 

If you see a compile-time warning I ike the foil owing: 

Warning 829: Implicit conversion of string literal to 'char*' 
is deprecated. 

These could be suppressed by a cast or const_cast I ike the above, then no further 
messages will occur. Or they could be suppressed by using 4W829. A compile-time 
error is generated unless a cast is done, in which case there is no message, and a 
SIGBUS signal 10could degenerated at runtime. 

Note that if you used a cast at compile-time to suppress the error/warning you will 
have no idea where to change the code to fix the runtime abort. If you want to find 
the source of your problem, look for const_cast or warning 829, or any indication that 
you put the cast in the source. When using the debugger, you can print out what 
you're trying to modify and search for the string to find the source of the problem. 

In A.03.15, A.01.23 and prior compiler versions, only floating-point constant values 
were placed in read-only memory. Other constants and literals were placed in 
read-write memory. 

• HP aC-F-Fcontinues to morestrictly conform totheC-F-FStandard, enabling porting 

to additional platforms. Due to closer conformance with the standard, you may see 
more compile time warnings and errors. 


= "quoted string"; 

// Error 203 
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I n prior compiler versions, Warning 829 was issued for assignments and 
initializations. The compiler now also generates Warning 829 for return statements 
and function calls where appropriate. This warning may help in finding problems 
with the new 4€Slit default (see prior bullet item). The following example generates 
the messages below: 

const foo=5; 


char ’^f(char*p) { 

return "goodbye"; 

} 

int main() { 

f("hello"); 
return 0; 

} 

aCC -c foo.C 

Error (future) 600: "foo.C", line 1 # Type specifier is omitted, "int" is 

no longer assumed, 
const foo=5; 


Warning 829: "foo.C", line 4 # Implicit conversion of string literal to 
'char *' is depricated. 
return "goodbye"; 

Warning 829: "foo.C", line 8 # Implicit conversion of string literal to 
'char *' is deprecated, 
f("hello"); 

Error (future) 600 is now generated (in conformance with the C++standard) for 
cases I i ke the fol I owi ng: 

Error (future (600) : 

Type specifier is omitted; "int" is no longer assumed. 

const foo=5; //error 600 

static bar() . //error 600 

The fol lowing code corrects the errors: 

const int foo=5; 
static int bar () . 

• HP aC++now provides function try blocks, as defined in the C++Standard. 

Function try blocks are sometimes necessary with class constructor destruction. A 
function try block is the only means of ensuring that all exceptions thrown during 
the construction of an object are caught within the constructor. 

• Assert and #jnassert preprocessor directives allow you to set a predicate name or 
predicate name and token to be tested with a #if directive. The-ext option must also 
be specified at compile and link time. 

• Most frequently reported migration issue: enum x {xl, }; 

The trailing comma is an error, and aC-F+now generates Warning 921. 
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• Behavior of the 4fn[d] and -FM [d] options has changed. When used with the -E 
option, only dependency file information is generated, and there is no preprocessing 
output. 

Behavior when combining the 4fn[d] or -FM [d] option with the -P option is 
unchanged. Both dependency information and preprocessing output are generated. 

• The-Fuc option allows you to change the compiler default (signed char) and treat an 
unqualified (plain) char data type as unsigned char. This may help in porting code 
from other envi ronments to H P-U X. 

• As a debugging aid, HP aC++predefinesthreestring variables for each current 
function. This functionality provides compatiblity with theC99 standard and with 
GNU /gcc styl e codi ng. 

For C99 style coding: 

_func_ indicates the function name as it appears in the source. 

For GNU/gcc style coding: 

_FUNCTION_ indicates the function name as it appears in the source. 

_PRETTY_FUNCTION_ indicates the function name, its argument types, and 

its return type. 

You can use the predefined variables in your code, as in the following examples. 

For C99 style coding: 

void foo () { 

printf("The function name is %s.\n", _func_); 

} 

Output from the example would be: 

The function name is foo. 

For GNU/gcc style coding: 

tinclude <stdio.h> 

class a { 
public: 
sub (int i) 

{ 

printf ("_FUNCTION_ = %s\n", _FUNCTION_); 

printf ("_PRETTY_FUNCTION_ = %s\n", _PRETTY_EUNCTION_); } 

}; 


int main (void) 
{ 

a ax; 

ax.sub (0); 
return 0; 


Output from the example would be: 
FUNCTION_ = sub 

PRETTY_FUNCTION_ = int a::sub (int) 
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Note, these names are not macros. They are predefined string variables. For 

example, #ifdef_ ^function_ has no special meaning inside a function, si nee the 

preprocessor does not recognize_ ^function_. 

Also note, the names_ function_,_pretty_function _, and_ func _are 

reserved for use by the compiler. If any other identifier is explicitly declared using 
any of these names, the behavior is undefined. 

• A macro can be defined to accept a variable number of arguments, much as you 
would define a function. This provides compatiblity with the C99 standard and 
GNU/gee style coding. If you have coded your macros in GNU/gee style, you can 
expect GN U/gee style behavior. I f you have coded your macros to C99 standards, you 
can expect C99 style behavior. 


For C99 style coding: 

If there is an elipsis (...) in the identifier-list in the macro definition, then the trailing 
arguments, including any separating comma preprocessing tokens, are merged to 
form a single item: the variable arguments. The number of arguments so combined is 
such that, following merger, the number of arguments is one more than the number 

of parameters in the macro definition (excluding the...).Any va arcs identifier 

occuring in the replacement list is treated as if it were a parameter. The variable 
arguments form the preprocessing tokens used to replace it.Following are examples: 

tdefine debug(...) fprintf(stderr, VA ARGS_) 

#define showlist(...) puts(#_VA_ARGS_) 

#define report (test, ...) ((test)?puts(#test) :printf(VA_ARGS_)) 

debug("Flag"); 
debug("X = %d\n", x); 

showlist(The first, second, and third items.); 
report (x>Y, "X is %d but y is %d", x, y) ; 

Will be expanded to: 

fprintf(stderr,"Flag" ); 

fprintf(stderr,"X = %d\n", x ); 

puts( "The first, second, and third items." ); 

( (x>y)?puts("x>y") :printf("x is %d but y is %d", x, y)) ; 

For GNU/gee style coding: 

Similar to the variable arguments function described above, a macro can accept a 
variable number of arguments. Following is an example: 

tdefine Myprintf(format, args...) \ 
fprintf (stderr, format, ## args) 

Myprintf ("%s:%d: ", input_file_name, line_number) 

Will be expanded to: 

fprintf (stderr, "%s:%d: " , input_file_name, line_number) 

Note the use of ## to handle the case when args matches no arguments. I n this case, 
args is empty, and if there is no ##, the macro expansion could be like the foil owing 
invalid syntax: 

fprintf (stderr, "success!\n" , ) 
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By using ##, the comma is concatenated with empty valued arguments, and is 
discarded at macro expansion. 

I n the case mentioned above, gcc currently discards only the last preceding sequence 
of non-whitespace characters, while H P aC-H-discards the last preprocessor token. 

• Alignment of the long double data type in 64-bit mode (-fOA2.0W) is now 16-bytes. 
This insures compatibility with the HP PA-RI SC ABI and H P C. I n particular, the 
layout and alignment of a struct that contains jmp_buf are now identical for HP C 
and HP aC-H-(since jmp_buf is a typedef that is defined with a long double). 

For codecompiled with the prior 8-byte default, a problem occurs when a long double 
is a field in a class, struct or union. When the structure in question is shared 
between C and C-F-Fthere is a 50% chance that the fields are not on the same offsets 
in both languages, and the wrong data will be accessed. 

Symptoms of this problem might be: 

— wrong runtime results and corruption 

— various aborts if there are pointers that occur after the long double fields 

Note, if you must usethe prior 8-byte alignment for long double, use the 
-Wc,-longdouble,old_alignment option. 

• The Rogue Wave Standard C-F-FLibrary 1.2.1 (libstd) and Tools.h-F-F7.0.6 (librwtool) 
are not thread safein all cases. The-D_HPACC_THREAD_SAFE_RB_TREE 
preprocessor macro insures thread safety. 

For more detail, refer to the H P aC-F-FOnlineProgramma's Guide and choose the 
Threads and Parallel Processing section. 

• Preview documentation and man pages are provided for a future release of the 
Rogue Wave Standard C-F-FLibrary 2.x.These documents are online in HTM L 
format. Refer to Chapter 3 of these release notes. 

• Manual pages are located at /opt/aCC/shar^man/man3.Z. To insure that you invoke 
a man page for the library in which you are interested, specify the appropriate 
section 3 sub-section. For example, to find the man page for the copy command: 


man 

3s 

copy 

# 

finds 

the 

Standard Components 

version 

man 

3f 

copy 

# 

finds 

the 

old Standard C++ Library (libstd) 





version 



man 

3n 

copy 

# 

finds 

the 

future Standard C++ 

Library preview version 
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Version A.03.13 Features 

Features introduced in the prior release, H P aC++version A.03.13, are listed below. 
They apply to H P-UX 11.x operating systems. 

The HP aC++OnlineProgramma's Guide cental ns full documentation. (See Chapter 3 
of these release notes for access instructions.). 

• The latest linker patch (PHSS_19866) is needed in order to build shared libraries 
and to use the -tobjdebug option. See these release notes. Chapter 2, Current Linker 
Required, for details. 

• Header FileCaching is an additional, simplified method of precompiling header files. 

• A new debugging option, -fobjdebug, enables faster links and smaller executable file 
sizes for large applications. 

The latest linker patch (PHSS_19866) is needed in order to use -fobjdebug. See these 
release notes, "Chapter 2, Current Linker Required," for details. 

• Additional Options for Standardizi ng Your Code: 

— -Wc,-ansi_for_scope,[on] enables standard scoping rules for init-declarations in 
"for" statements. 

— -Aa sets all C-f-f standard options on (currently Koenig lookup and "for" scoping 
rules). 

• Additional Options for Code Optimization: 

— -FOoptlB/el^#=namel[,name2,...,nameN] 

— -FO[no]promote_indirect_calls 

— -FOreusedir=DirectoryPath 

• A new template option, -Finst_directed, to suppress assigner output in object files. 
Use it instead of the -Finst_none option with code that contains explicit 
instantiations only and does not require automatic (assigner) instantiation. 

• The pragma pack directive allows you to specify the maximum alignment of class 
fields having non-class types. This pragma may be useful when importing code from 
other architectures where data type alignment may be different from default 

HP-RISC alignment. 

• A newj apanese language version of the HP aC-F-FOnline Programmer's Guide is 
located at: /opt/aCC/html/jaJ P.Sj IS 

• -fM [d] and -Fm[d] options to output the header files upon which your source code 
depends in a format accepted by the make(l) command. 

• -FWe option to selectively interpret a warning or future error as an error. 

• The_HP_aCC predefined macro to identify the H P aC-F-Fcompiler. 

• At this release, the-Finline-level option defaults to 1.1 n the prior versions, A.01.09, 
A.01.12, A.03.05, A.03.10, the default was 0 and no inlining was done (the same 
effect as the -Fd option). 

This change was made based on customer feedback regarding object file size and 
runtime performance. 
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Version A.03.10 Features 

Features introduced in the prior release, H P aC++version A.03.10, are listed below. 
They apply to H P-UX 11.x operating systems. 

The HP aC++OnlineProgramma's Guide cental ns full documentation. (See Chapter 3 
of these release notes for access instructions.). 

• TheH P aC++Online Programmer's Guide has been updated from H P CDE format to 
HTML format viewable with your HTML browser. For details and access 
instructions, seeChapter 3 of these release notes under Online Documentation. 

• Standards based features include the following:. 

— covariant return types (except for covariant return types with multiply 
inheriting types) 

— declarations in for and conditional statements 

Note: I n the case of for statements, you must specify the 
-Wc, -ansi_for_scope,on option. 

— Koenig lookup 

Note: You must specify the -Wc, -koenig_lookup,on option. 

• The-I header file option invokes view-pathing. Thisoption overridesthedefault 
-I <directory> header file search path. 

• The-i-inline_level<num>option now defaults toO, noinlining is done (the same effect 
as the 4d option). 

• Additional options for verbose compile and link information: 

— -fdryrun - Requests compiler subprocess information without running the 
subprocesses. 

— -rtime - Requests subprocess execution times. 

— -V - Requests the current compiler and linker version numbers. 

• Huge data - Support for uninitialized, non-automatic data objects to a maximum size 
of 2^1 bytes for arrays and C style structs and unions. 

• Advanced options to support optimization of parallel code on HP9000 K-class and 
V-class servers: 

— 40[no]autopar - Parallelize loops that are safe to parallelize. 

— 40[no]dynsel - Enable workload-based dynamic selection of parallelizable loops. 

— 40[no]loop_block - Enable [disable] blocking of eligible loops for improved cache 
performance. 

— 40[no]loop_unrolljam - Enable [disable] loop unrolling and jamming. 

— 40[no]parallel - Transform [do not transform] eligible loops for parallel 
execution on a multiprocessor system. 

— .40[no]report[=<report_type>] - Produce a Loop Report 

— 40[no]sharedgra - Enable [disable] global register allocation. 
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— -H;m<targel;>- Compile code for optimization with a specific machine 
architecture. 

Note: The Parallel Programming Guide for HP-UX Systems provides in depth 
information about code parallelization. Refer to Chapter 3 of these release notes. 

• Option -fOO<osname>allows you to set the target operating system for the compiler. 

• The 40inlinebudget=<n>option now works correctly. 
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Version A.03.04 Features 

Features introduced in the prior release, H P aC++version A.03.04, are listed below. 
They apply to H P-UX 11.x operating systems. 

The HP aC++OnlineProgramma's Guide cental ns full documentation. (See Chapter 3 
of these release notes for access instructions.). 

• TheaC++default template instantiation mechanism has changed to compile-time 
instantiation (CTTI). For source code containing templates, the new default may 
result in faster compile-time processing. 

The previous default behavior remains available by specifying the -Hnst_auto 
command-line option when compiling and linking. If you provide archive or shared 
libraries for distribution, you may want to use -Hnst_auto to insure consistent 
behavior between each distribution of your libraries. 

Also, if you provide either archive or shared library products, and your customers 
need to use the prior template instantiation default in their builds, you must compile 
your libraries by using the -Finst_auto option. 

Refer to the H P aC-F-FOnlineProgramma's Guide and to the online technical paper. 
Using Templates in HP aC-F-F, for details about template instantiation and 
migration. For access instructions, seeChapter 3 of these release notes under Online 
Documentation.. 

• Member templates are supported, including those in pre-compiled headers. 

• Updated versions of the Rogue Wave Standard C-f-fL ibrary (version 1.2.1) and the 
Tools.h-F-FFoundation Class Library (version 7.0.6 ) are provided. HTM L 
documentation for these libraries is also updated; seeChapter 3 of these release 
notes under Online Documentation. 

• The H P aC-F-FOnline Programmer's Guide has been updated, including additional 
migration and template information. For access instructions, see Chapter 3 of these 
release notes under Online Documentation. 

• Thetechnical document. Using Templates in HP aC-F-F, has been updated to describe 
the new default, compile-time tempi ate mechanism and additional information 
about template libraries. For access instructions, seeChapter 3 of these release notes 
under Online Documentation. 

• The aC-F-Fcompiler on H P-UX 11.x includes support for both the 32-bit data model 

(I LP32) and the 64-bit data model (LP64). For ILP32, integer, long, and pointer data 
is 32 bits in size. For LP64, long and pointer data is 64 bits in size, an integer is 32 
bits. The default target architecture continues to be determined by the host system 
and the/usr/lib/sched.models file. The default compilation mode remains unchanged 
(32-bit). 

The new H P-UX 64-bit Porting and Transition Guide includes extensive 32-bit/64-bit 
information. 64-bit information is also found in the H P Linker and Libraries Usa 
Guide and in theHP aC-F-FOnlineProgramma's Guide For access instructions, see 
Chapter 3 of these release notes under Online Documentation. 

• New parameters to the -FDA[architecture] option allow you to compile in either 
32-bit mode or 64-bit mode. 
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4OA2.0N (the new name for 4OA2.0) specifies 32-bit (narrow) mode for the PA-RISC 
2.0 architecture. This is the default on 64-bit systems. 

-I-DA2.0W specifies 64-bit (wide) mode for the PA-RISC 2.0 architecture. Specifying 
-I-DA2.0W generates 64-bit SVR4 Executable and Linking Format (ELF) object files 
for PA-RI SC 2.0. This option is specific to the PA-RI SC 2.0 architecture. 

• By default, the new_LP64_preprocessing macro is defined by the compiler when 

processing in 64-bit mode. The compiler defines the_PA_RISC2_0 macro for PA2.0 

in both 32-bit and 64-bit modes. 

You can use these macros within conditional directives to isolate 64-bit code.. 

• New 64-bit system libraries are located in /usr/lib/pa20_64. 32-bit libraries remain in 
/usr/lib. 

• The- fZ compiler option is the default in 64-bit mode (PIC on). The default in 32-bit 
mode remains non-PIC. 

• Advanced optimization options, -fOmultiprocessor and -fOextern, are provided to 
optimize code for processor configuration and external symbol usage, respectively. 


20 


Chapter 1 



Features 

Migrating from HP C++ (cfront) to HP aC++ 


Migrating from HP C-H-(cfront) to HP aC-H- 

The compiler listsErrors, Future Errors and Warnings. Expect to see more warnings, 
errors and future errors reported in your code, many related to standards based syntax. 
For more complete information, refer to: 

1. HP aC++Transition Guide at the following world wide web URL: 

http://www.hp.com/go/C++ 

2. For general background information and experience, subscribe to the cxx-dev list 
server (like a notes group). Send a message to majordomo(acxx. cup. hp.com with the 
following command in the body of the message: subscribe list-name 

Available list-names are as follows: 

cxx-dev HP C++ Development Discussion List 

cxx-dev-announce HP C++ Development Announcements 
cxx-dev-digest HP C++ Development Discussion List Digest 

cxx-dev-announce is also broadcast tocxx-dev, so there is only a need to subscribe to 
one of the lists. The digest also includes both cxx-dev and cxx-dev-announce. 

For additional help or information about the list server, send a message to 
majordomo(acxx.cup.hp.com with the following command in the body of the message: 
help 

Also, search the cxx-dev archives at the following URL: 

http://WWW.devresource.hp.com/devresource/Forums/Forums.html 

3. For specific support questions, contact your HP support representative. 

4. For generic C-F-F questions, see documents and URL's listed in theHP aC-F-FOnline 
Programmer's Guide Information Map. 

Some migration issues are listed below: 

• The overload resolution for operators has been updated to reflect the C-f-f standard. 
You may see some additional "ambiguous" function error messages displayed. 

• Most frequently reported migration issue: enum x {xl, }; The trailing comma is an 
error, and aC-F-Fgenerates Warning 921. 

• Changes to temporary creation for rvalues used to initialize return values which are 
const references now causes: 

Error 652: Exact position unknown; near file, line#. 

Initialization of the result <some const &> requires creating a 
temporary, yet the temporary's lifetime ends with the return from the 
function. 

• You can bracket your H P aC-F-Fchanges with the macro defined by the draft 
standard. For example: 

#if _cplusplus >= 199707L 

//HP aC++ Code 

#endif // _cplusplus >= 199707L 
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• if you are using directed mode instantiation with the cfront based compiler, an awk 
script can be used to convert your file to an instantiation file that uses the explicit 
instantiation syntax. Note that explicit instantiation syntax can be used to 
instant!ate a template and all of its member functions, an individual template 
function, or a template class's member function. The H P aC++Online Programmer's 
Guidecontains an example script. 

• In atemplate, a name with a parameter-dependent qualifier is not taken to be a type 
unless it is explicitly declared as one with thetypename keyword. 

You need to explicitly declare a type or a member function type using thetypename 
keyword when all of the following are true: 

— The code is inside a template. 

— The name is qualified (i.e., it has a token in it). 

— The qualifier (to the left of thetoken) depends on a template parameter. 

For example, the fol lowi ng code i ncl udes the typename keyword to declare iterator as 
a type: 

#include <list> 
template <class Element> 
class Foo { 
public: 

list<Element> e; 

typedef typename list<Element>::iterator Mylterator; 

}; 

For more information, refer to the HP aC-F-FTransition Guide at the fol I owing World 
Wide Web URL: 

http://WWW.hp.com/esy/lang/cpp/tguide 
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Installation Information 


Read this entiredcxument and any other release notes or readme files you may have 
before you begin an installation. 

To install your software, run theSD-UX swinstall command. It will invoke a user 
interface that will lead you through the installation. For more information about 
installation procedures and related issues, refer to Managing hp-ux software with 
SD-oxand other README, installation, and upgrade documentation provided or 
described in your H P-UX 11.x operating system package. 

Depending on your environment, you may also need documentation for other parts of 
your system, such as networking, system security, and windowing. 

HP aC++requires approximately 100 M B of disk space: approximately 50 M B for the 
files in /opt/aCC, 10 MB for WDB, and 30M B for DDE. For more precise sizes, use the 
command: 

/usr/sbin/swiist -a sizeYourProductNumba 
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Patch Installation Requirements 

For H P-UX 11.x operating systems, the HP aC++run-time library Patch, PHSS_20055, 
(or its successor) must be installed prior to running HP aC-H-. The patch is not required 
for the H P-UX Hi operating system. 

I n addition, it is recommended that you install the core patches distributed on the 
Support Plus media. 
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Current Linker Required 

HP aC++A.03.27 requires the linker patch PHSS_21947, or its successor. 

The patch is needed for creation of shared libraries with the-b option. (The 
4fiosmartbind option is passed to the linker.) 

CAUTION No errors occur if you have the wrong linker. However, static constructors in the shared 

I i brary wi 11 not be executed. 

The patch is also required in order to use the -tobjdebug option to write debug 
information in object files. If the patch is not present, the -tobjdebug option is ignored. 

Incremental linking is only available on HP-UX Hi or a subsequent patch or release. 
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Current Run-time Support Library Required 

To work correctly, an application must be linked to or run with an HP aC-H-run-time 
support library (libCsup.a or libCsup.sl) that comes with this version of HP aC-H-or a 
subsequent version. Linking with an older version of libCsup.a or running your 
application with an older version of libCsup.sl (the default) may cause spurious failures. 
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Attention Softbench Users 

You should install Softbench (DDE) before installing H P aC++. This is because H P aC++ 
is packaged with DDE and a DDE specific patch. Not installing in this order results in 
an unsupported configuration. 
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3 Related Documentation 


Dcxu mentation for HP aC++is described in the following sections. 
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Online Documentation 

The following online dcxumentation is included with theHP aC++product. 

HP aC-H-Online Programmer's Guide 

Access the guide in any of the foil owing ways: 

• Use the Thelp command-line option: 

/opt/aCC/bin/aCC +help 

• From your web browser, enter the appropriate URL: 

file:/opt/aCC/html/C/guide/index.htm (English) 
file:/opt/aCC/html/ja_JP.SJIS/guide/index.htm (Japanese) 

To seej apanese characters when using the Netscape browser, choose: 

1. Options 

2. Document Encoding 

3. J apanese (Auto-Detect) 

NOTE All of the files composing the English version of the guide are installed in the 

/opt/aCC/html/C di rectory. I f you choose to move the enti re guide to a different 
location without having to edit any links, you will need to move all of the 
subdirectories in /opt/aCC/html/C. All of the files composing the J apanese guide are 
_ installed in /opt/aCC/html/jaJ P.SJ IS/. 


• TheEnglish guide (excluding Rogue Wave documentation) is also available on the 
World Wide Web at the following URL: 

http://docs.hp.com/hpux/development/ 


Using Templates in HP aC-H- 

Thistechnical document summarizes tempi ate features defined in theC-H-standard and 
describes template instantiation as implemented in HP aC-H-. It is provided with HP 
aC-H-in both postscript and HTML format in the following locations: 

/opt/aCC/newconfig/TecDocs/templates.ps 
/opt/aCC/htral/C/tempdates/templates.htm 

Note that you can select the HTM L version from the initial window of the HPaC-H- 
Online Programmer's Guide 

HP-UX 64-bit Porting and Transition Guide 

Helps developers transition applications from an HP-UX 32-bit platform to the HP-UX 
64-bit platform. 

This document is available on the H P-UX 11.x CD-ROM and on the World Wide Web at 
the foil owing URL: 

http://docs.hp.com/hpux/development/ 
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HP-UX Linker and Libraries Online User Guide 

To access, use the command: 

/usr/ccs/bin/ld +help 


HP Wildebeest Debugger (HP WDB) 

All of the HP WDB documentation is available online in the following directory: 

/opt/langtools/wdb/doc 

The most current H P WDB and its related documentation is 
available online at the following World Wide Web directory: 

http://www.hp.com/go/wdb 


Rogue Wave Software Standard C-H-Library 2.2.1Class Reference 

This reference contains an alphabetical listing of all of the classes, algorithms, and 
function objects in the updated Rogue Wave Standard C++Library. The library includes 
the standard iostream library and has namespace std enabled. 

The reference is provided as HTM L formatted files. View these files with an HTM L 
browser by opening /opt/aCC/html/lIbstd_v2/stdref/index.htm or by selecting from the 
initial window of the HP aC++OnlineProgrammer's Guide 

Rogue Wave Software Standard C-H-Library 2.2.1 User's Guide 

This guide gives information about library usage and includes an extensive discussion of 
locales and iostreams. 

The guide is provided as HTML formatted files. View these files with an HTML 
browserby opening /opt/aCC/html/libstd_v2/stdug/index.htm or by selecting from the 
initial window of the HP aC++OnlineProgrammer's Guide 

Rogue Wave Software Standard C-H-Library 1.2.1Class Reference 

This reference provides an alphabetical listing of all of the classes, algorithms, and 
function objects in a prior Rogue Wave implementation of the Standard C++Library. 

The reference is provided as HTM L formatted files. View these files with an HTM L 
browser by opening/opt/aCC/html/libstd/ref.htm or by selecting from the initial window 
of the HP aC++Online Programmer's Guide 

Rogue Wave Softwa re Tool s.h -H- 7.0.6 CI ass Reference 

This reference describes all of the classes and functions in the Tool s.h++Library. It is 
intended for use with Rogue Wave Standard C++Library 1.2.1. 

The reference is provided as HTM L formatted files. View these files with an HTM L 
browser by opening/opt/aCC/html/librwtool/ref.htm or by selecting from the initial 
window of the HP aC++OnlineProgrammer'sGuide 
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NOTE Although the documentation for Appendix A is supplied with aC++, this is an obsolete 

interface to Tools. h++that predates the version that is integrated with the STL. (If 
building from the Rogue Wave source, you must compile with -DRW_NO_STL.) 

There are 8 templates documented in the main part of the manual as "still supported". 
This is incorrect. The interfaces for the following 8 templates must be translated to the 
new interface with two extra template arguments: 

RWTPtrHashDictionary ==> RWTPtrHashMap 

RWTPtrHashDictionarylterator ==> RWTPtrHashMapIterator 
RWTPtrHashTable ==> RWTPtrHashMultiSet 

RWTPtrHashTablelterator ==> RWTPtrHashMultiSetIterator 
RWTValHashDictionary ==> RWTValHashMap 

RWTValHashDictionarylterator ==> RWTValHashMapIterator 
RWTValHashTable ==> RWTValHashMultiSet 

RWTValHashTablelterator ==> RWTValHashMultiSetIterator 

Refer to defect J AGaa90638. 


NOTE Refer to the I nformation Map in the HP aC++Online Programmer's Guide for how to 

obtain additional Rogue Wave documentation. 

HP aC-H-Release Notes 

This is the document you are reading. Theonline ASCI I file can be found in 
/opt/aC C/newconfi g/R d N ot es/AC X X. rel ease, n ot es. 

HP PA-RISC Compiler Optimization Technology White Paper 

This paper describes the benefits of using optimization. It is available in the postscript 
fi I e /opt/I angtool s/newconfi g/wh i te_papers/opt i mi ze. ps 

Online Manual Pages 

Online manual pages for aCC and c++filt are at /opt/aCC/share/man/manl.Z. 

Library manual pages are located at /opt/aCC/shar^man/man3.Z. To insurethat you 
invoke a man page for the library in which you are interested, specify the appropriate 
section 3 sub-section. For example, to find the man page for the copy command: 

man 3s copy #finds the Standard Components version 

man 3f copy #finds the old Standard C++ Library (libstd) version 

man 3n copy #finds the new Standard C++ Library version 

J apanese man pages are located at: 

/opt/aCC/share/raan/ja_JP.eucJP/raanl.z and 

/opt/aCC/share/man/ja_JP.eucJP/man3.z (euc character set) 

/opt/aCC/share/man/ja_JP.SJlS/manl.z and 

/opt/aCC/share/man/ja_JP.SJIS/man3.z (SJIS character set) 


HP DDE Debugger Online Help 

Select help from the DDE Menu Bar. 
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Online C-H-Example Source Files 

OnlineC++examplesource files are Icxated in the directory, 

/opt/aCC/contrib/Examples/RogueWave. These include examples for the Standard C++ 
Library and for theTools.h++Library. 
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Printed Documentation 

• HP aC++Rei ease Notes is this document. A printed copy of the release notes is 
provided with the H P aC++ product. 

Release notes are also provided online, as noted above. 
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Other Documentation 

Refer to the H P aC++OnlineProgramma's Guidel nformation Map for documentation 
listings, URL's, and course information related to the C++language. Also, see below. 

The following documentation is avail able for use with HP aC++.Toorder printed 
versions of Hewlett-Packard documents, refer to manuals(5). 

• Parallel Programming Guidefor HP-UX Systems (B6056-90006) describes efficient 
parallel programming techniques availablefor the 

HP Fortran 90, HP C, and HP aC-H-compilers on HP-UX. 

This document is avail able on the H P-UX 11.0 CD-ROM and on the World Wide Web 
at the following URL: 

http://docs.hp.com/hpux/development/ 

To order a paper copy, contact Hewlett-Packard's Support Materials Organization 
(SMO) at 1-800-227-8164 and provide the above part number. 

HP aC++WDrld Wide Web Homepage 

The HP aC-H-World Wide Web Homepage provides the latest information regarding: 

• Frequently Asked Ouestions 

• Release Version and Patch Table 

• Purchase and Support I nformation 

• Documentation Links (including Release Notes and Programming Guides) 

• Compatibility between Releases 

• WDB Debugger 

Access the Homepage at the foil owing URL: 

http : / /WWW. hp . com/go/C++ 


Compatibility between HP aC++Releases 

Maintaining binary compatibility is a key release requirement for new versions of HP 
aC-H-. The compiler has maintained the same object model and calling convention and 
remains compatible with the H P-UX runtime in the code that it generates as well as its 
intrinsic runtime library (libCsup) across the various releases of H P aC-H-and its 
run-time patch stream. 

For the Standard Template Library (libstd) and a generic component/tool library 
(librwtool), HP aC-i-+(as well as some other C-H-compilers) relies on Rogue Wave's 
Standard Library andTools.h-H-libraries. From the initial release of HP aC-H-through 
the patch release of version A.01.06, Rogue Wave's Standard Library version 1.2 and 
Tools.h-l-+version 7.0.3 compatible libraries were bundled with the compiler. 
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At the release of H P aC++A.01.07, the runtime libraries were updated to Rogue Wave's 
Standard Library version 1.2.1 and Tools.h++version 7.0.6. These new libraries 
introduced additional data members in some base cl asses resulting in incompatibility 
with the previous versions. For more details, refer to the HP aC++World Wide Web 
Homepage at the following URL and choose Compatibility between Releases: 

http:// WWW .hp.com/go/ct+ 


Floating-Point Exceptions Must be Raised Prior to Entering 
Library Routines 

Programmers who use floating-point arithmetic are reminded to insure that 
floating-point exceptions are raised before entering a library routine. For example a 
floating-point divide should be followed by a floating-point store. If you fail to do so, code 
within the library may raise the floating-point exception, interrupting the library code 
rather than the user code. 

This reminder is included si nee the unwind component of libel.a and libel.si uses 
floating-point operationsin more places than earlier versions of thelibrary. HP aC-H- 
uses unwind functionality to support throw/catch exception handling. Programs which 
don't raise floating-point exceptions before entering unwind library routines may have 
the exception raised from within the unwind routine. 

Difference in Class Size when Compiling in 32-bit versus 64-bit 
Mode 

The size of a class containing any virtual function varies when compiled in 32-bit mode 
versus 64-bit mode. The difference in size is caused by the virtual table pointer (a pointer 
to an internal compiler table) in the class object. The pointer is created for any class 
containing one or more virtual functions. 

When compiling the following example in 32-bit mode, the output is 8.1 n 64-bit mode, 
the output is 16. 

extern "C" int printf(const char *,...); 

class A { 
int a; 
public: 

virtual void foo(); //virtual function foo, part of class A 

}; 


void A::foo() { 

return; 

} 

int main () { 

printf("%d\n",sizeof(A)); 
} 


Content of .o Files may Change 

The following applies when you use an aCC command-line option that invokes the 
assignee 
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The content of a given .0 file can potentially change when it is used in a closure (with the 
-Hnst_close option) or link operation. The change may occur in either of the foil owing 
cases: 

• You change the order of .0 file's on the link line. For example, if you compile and link 
A.c and B.c multi pie times as follows, the contents of A.o and B.o may not be the 
same following the second link as they were foil owing the first link: 

aCC -c A.c B.c 
aCC A.o B.o 

aCC -c A.c B.c 
aCC B.o A.o 

0 You link a .0 file with different objects. I n the following example, the content of A.o 
may not be the same foil owing the second link as it was following the first link: 

aCC A.o B.o 


aCC A.o C.o 


The Named Return Value (NRV) Optimization 

Syntax: -Wc,-nrv_optimization, [off|on] 

The above syntax disables (default) or enables the named return value (NRV) 
optimization. For this optimization to work correctly in conjunction with exception 
handling, the application must delinked to an aC++run-time support library that comes 
with FI P aC++A.01.04 or a subsequent version. Linking with a prior library may cause 
spurious failures. If the shared version of this library is selected (default), the platform 
on which the application is run must also have that release of the FIP aC++run-time 
support library (libCsup.sl). 

The NRV optimization eliminates a copy-constructor call by allocating a local object of a 
function directly in the caller's context if that object is always returned by the function. 
For example: 

struct A { 

A(A constS); // copy-constructor 

}; 

A f(A constS x) { 

A a(x) ; 

return a; // Will not call the copy constructor if the 
} // optimization is enabled. 

This optimization will not be performed if the copy-constructor was not declared by the 
programmer. Note that although this optimization is allowed by the I SO/AN SI C-H- 
working paper, it may have noticeable side-effects. 

Example: aCC -Wc,-nrv_optimization,on app.C 
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Linker Compatibility Warnings 

Beginning with the H P-UX 10.20 release, the linker generates compatibility warnings. 

These warnings include H P 9000 architecture issues, as well as linker features that may 

change over ti me. Compati bi I ity warni ngs can be turned off with the 

-H/[no]compatwarnings linker option. Also, detailed warnings can be turned on with the 

-H/allcompatwarnings linker option. 

Link time compatibility warnings include the foil owing: 

• Linking PA-RI SC 2.0 object files on any system — PA-RI SC 1.0 programs will run on 
1.1 and 2.0 systems. PA-RI SC 2.0 programs will not run on 1.1 or 1.0 systems. 

• Dynamic linking with -A — If you do dynamic linking with -A, you should migrate to 
using the Shared Library Management Routines. These routines are also described 
in thesh_load(3X) man page. 

• Procedure call parameter and return type checking (which can be specified with -C) 
— The current linker checks the number of symbols, parameters, and procedure cal Is 
across object files. I n a future release, you should expect H P compilers to perform 
cross-module type checking, instead of the I inker. This impacts HP Pascal and HP 
Fortran programs. 

• Duplicate names found for code and data symbols — The current linker can create a 
program that has a code and data symbol with the same name. I n a future H P-U X 
release, the linker will adopt a single name space for all symbols. This means that 
code and data symbols cannot share the same name. Renaming the conflicting 
symbols solves this problem. 

• Unsatisfied symboisfound when I inking to archive libraries— If you specify the-v 
option with the -K/allcompatwarnings option and link to archive libraries, you may 
see new warnings. 

• Versioning within a shared library — If you do versioning within a shared library 
withtheHP_SHLIB_VERSION (C and C-F+) or the SHLI B_VERSION (Fortran and 
Pascal) compiler directive, you should migrate to the industry standard and faster 
performing library-level versioning. 
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4 Problem Descriptions and Fixes and 

Known Limitations 


This chapter summarizes the known problems and limitations of the current version of 
H P aC++except as otherwise noted. 


NOTE HP-UX 10.10 is the last supported OS for PA-RISC 1.0 architecture machines. HP-UX 

11.x and Hi no longer support execution of PA-RI SC 1.0 code, and 11.x and Hi compilers 
no longer support the compilation of PA-RI SC 1.0 code. 

Seethe latest HP-UX Software Status Bulletin support document for other known 
problems. 
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Known Problems 

Customers on support can use the product number to assist them in finding SSB and 
SRB reports for H P aC++. The product number you can search for is B3910BA. 

To verify the product number and version for your HP aC++compiler, execute the 
following HP-UX commands: 

what /opt/aCC/lbin/ctcom* 


what /opt/aCC/bin/aCC 

Following are known problems and workarounds. 

Incompatibilities Between the Standard C-H-Library Version 
1.2.1 and the Draft Standard 

As the ANSI C-F-Fstandard has evolved over time, the Standard C-F+Library has not 
always kept up.Such is the case for thetimes function object in the functional header file. 
I n the standard, times has been renamed to multiplies. 

If you want to use multiplies in your code, to be compatible with the I SO/ANSI C-F+ 
standard, use a conditional compilation flag on the aCC command line. For example, for 
the following program, compile with the command line: 

aCC -D_HPACC_USING_MULTIPLIES_IN_FUNCTIONAL test.c// test.c 

int times; //user defined variable 
tinclude <functional> 

// multiplies can be used inint main() {} 

// end of test.c 

Depending on the existence of the conditional compilation flag, functional defines either 
times or multiplies, not both. So, if you have old source that uses times in header 
functional and also new source that uses multiplies, thesources cannot be mixed. Mixing 
the two sources would constitute a non-conforming program, and the old and new 
sources may or may not link. 

If your code uses the old name times, and you want to continue to use the now 
non-standard times function object, you do not need to do anything to compile the old 
source. 

Changes to the math.h System Header File 

At the H P-UX 11.00 release, the math.h header file has changed in the following ways: 

• fmax and fmin are new functions. If you used these function names in your code in a 
prior release and want to continue using them, you must rename your functions. If 
this Isa problem in your code, you will see an error I ike the foil owing: 

the overloading mechanism cannot tell a double (double, double) 
from a ... (1103) 

• The_ABS function has been renamed. To continue using this function, replace any 
call to_ABS() with abs(). 
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Conflict between macros.h and numeric_limits Class (min and 
max) 

If your code includes/usr/include/macros.h, note that the min and max macros defined in 
macros.h conflict with the min and max functions defined in the numeric_limits class of 
the Standard C++Library. The following code, for example, would generate a compiler 
Error 134: 

nuineric_limits<unsigned int> : :max () ; 

If you must use the macros.h header, try undefining the macros that conflict: 


tinclude <macros.h> 
tundef max 
tundef min 


Unsatisfied Symbols if Using Non-current Run-time Support 
Library 

If you see a message I ike the foil owing, you may be using a non-current version of the H P 
aC-H-run-time support library. 

/opt/aCC/lbin/ld: Unsatisfied symbols: 

Class tables [Vtable] dependent on key function: 

"_versioned_type_info::~_versioned_type_info()" (data) 

For example, if you are a library distributor, you must ensure that your customers use 
the same or a newer version of the libCsup run-time library as you. If necessary, you 
should install the most current H P aC-F+library support patch and distribute this patch 
to your customers. 

Unsatisfied Symbols for Inline Template Functions 

If you use explicit instantiation instead of closing a library, and you compile with the 
-Hnst_auto option, then unless you compile with the-Hnst_none option, unsatisfied 
symbols will be generated for inline tempi ate functions that are too large to inline. 

Potential Binary Incompatibility of Objects Built with HP-UX 
10.10,10.20 HP aC-H- 

The underlying type corresponding to the "size_t" typedef has changed from unsigned int 
to unsigned long. Similarly, "ptrdiff_t" has changed from int to long. These changes 
makethe 10.10, 10.20 HP aC-H-runtime libraries incompatible with subsequent 
compiler releases. The changes will cause compatibility problems when size_t is used in 
a non-extern "C" interface. (The mangled signature would be different.) 

Due to these changes, if any object files are recompiled or linked, then all HP aC-H-files 
must be recompiled. This implies that third party libraries in archive form also need to 
be recompiled or resupplied. 
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Potential Source Incompatibility of Objects built with HP-UX 
10.10,10.20 HP aC-H- 

When your code overloads system header file functions, it is possiblethat C++source 
files that compile without error using HP aC++for H P-UX 10.10 or 10.20 might not 
compile with a subsequent compiler release. The example below shows why this 
potential problem exists. 

1: #include <time.h> 

2: time_t ff (time_t t) { return t; } 

3: time_t ff (long t) { return t; } // This causes a duplicate. 

4: time_t ff (char t) { return t; } // This causes an ambiguity. 

5: int main () { long tt = ff (IL); return 0; } 

ff is overloaded to take either a time_t, long, or char parameter. On a 10.10 or 10.20 

system where time_t is a long, the cal I toff in main resolves toff(time_t). On a 10.30 
system, however, where time_t isan int, the code fails to compile: 

Error 225: "tl.C", line 4 # Ambiguous overloaded function call; more than 
one acceptable function found. Two such functions that matched were "int 
ff(char)" ["tl.C", line 5] and "int ff(int)" ["tl.C", line 3]. int main () { 

long tt = ff (IL); } 


Binary Compatibility Between HP-UX 11.00 Bundle from the 
Support Plus Media and HP-UX 11.00 

An application that ran on theHP-UX 11.00 release will generally continue to run with 
the same behavior on 32-bit and 64-bit HP-UX 11.00 bundle from the Support Plus 
Media provided that any dependent shared libraries are also present. An executable is a 
binary file that has been processed by the HP linker with id or indirectly with the 
compiler, and can be run by the H P-UX loader(exec). 

The following items describe exceptions to binary compatibility between 11.00 and the 
Support Plus Media. These conditions can occur during your development process, but 
rarely affect deployed applications. 

Binary Incompatibilities without Changes 

Under the following conditions, when you compile your source code without any changes 
(to source code, options, or makefiles), you create relocatable object files or executables 
that cannot be moved back to an 11.00 system. 

• Instrumented code with PBO or 404 optimization 

If you use PBO (+i compiler option) or the +04 option during development and 
recompile with your bundle from the Support Plus Media compiler, you create 
instrumented objects (ISOM) that an 11.00 system does not recognize. 

You receive one of the fol lowi ng types of error messages if you attempt to I i nk the 
objects created using your bundlefrom the Support Plus Media compiler on an 11.00 
system.Example 1: If you compile with +03 or +04, you receive the fol I owing message 
and a stack trace: 

report error(13-12299-434) to your nearest HP service representative 
(8911) 
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Example2: If you compile with "+02 +i", you receive the following message and a 
stack trace: 

Backend Assert ** Ucode versions earlier then v.4 no longer supported. 
(5172) 


NOTE This code is not backward-compatible with the 11.00 release. I nstrumented object 

files cannot be moved backward. 


Binary Incompatibilies with Changes 

When you make changes to your source code, options, or makefiles to use new features of 
the bundlefrom the Support Plus Media release, you may introduce the following areas 
of binary incompatibility. You can apply patches to the 11.00 release to accommodate the 
relocatable object fileor executableon an 11.00 release for backward compatibility. 

• H uge Data Features 

If you make changes to your source code or usethe-Fhugesize=n option and 
recompile with your bundlefrom the Support Plus Media compiler to use huge data 
features (for example, declaring a very large array), you must install the 
PH KL_14088 kernel patch (or superseding patch) to use your executable with these 
features on an 11.00 system. You must also apply the PH SS_16587 aC-F-Fruntime 
and PHSS_16841 linker-tools patches (or superseding patches) for huge data 
support. 

• 64-bit Open Graphics Library Support 

The bundlefrom the Support Plus Media extension provides 64-bit OGL support to 
improve performance. If you make changes to your source code to recompile using 
these OGL headers, you receive the message "unresolved symbols" when you link 
your executableon an 11.00 system. 

• Compiling with -FDO and -FOlibcalls for Improved Math Performance 

If you recompileyour code with your bundlefrom the Support Plus Media compiler 
using +oiibcaiis and +doii.oep9812 options for improved performance, you may 
receive the message "unresolved symbols" if you link or run your new executable on 
an 11.00 system. (Possiblesymbols include: $$vsin2_20, $$vcos2_20, $$vsinf2_20, 
$$vcosf2_20, $$vcossi nf_20, $$vcossi n_20, $$expf_20, $$expf, $$vexpf2_20, 
$$vexp2_20.) I nstall the PHSS_14582 milli (or superseding) patch if you must link 
your executableon an 11.00 system. 

• Parallel Programming Enhancements 

If you change your source code and recompile it with your bundle from the Support 
Plus Media compiler to take advantage of parallel programming features, you 
receive the error "unresolved symbols" if you link your executableon an 11.00 
system. I nstall the PHSS-16587 aC-F-Fruntime patch and PHSS-16841 linker-tools 
patch (or superceding patches) and Support Plus Media driver to provide the correct 
driver and support library for an 11.00 system. 

• CXperf Profiling Tools 
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If you change options and recompile your source code with your bundle from the 
Support Plus Media compiler using the CXperf product, you do not produce profiling 
information if you run your executableon an 11.00 system. Install the PHSS_16841 
linker-tools patch (or superceding patch) and theCXperf product if you must use the 
CXperf product on an 11.0 system. 
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Known Limitations 

Some of these limitations will be removed in future releases of HP aC++. Please be 
aware that some of these limitations are platform-specific. 

• HP aC-H-does not support the xdb debugger. I nstead, use the H P WDB debugger or 
the HP DDE debugger. 

• 64-bit Limitations: 

— Use of optimization levels greater than 0 with debugging options is not 
supported. 

— Limitation when Unloading Shared Libraries in a 64-bit Application 

Normally, at program termination (exit) or at a call toshl_unload() or dIcloseO, 
all explicitly loaded libraries are closed automatically and static destructors are 
executed at that time. 

When a 64-bit application calls shl_unload() or dIcloseO and that causes libCsup 
to be unloaded, it fails when it executes static destructors at program 
termination. This causes a program abort, since related code and data are no 
longer present. See defect J AGaa86491. 

• HP aC-H-does not and will not in the future support installation and/or execution on 
HP-UX 9.x, 10.00, or 10.01 systems. 

• HP aC-H-does not support large files (i.e., greater than 2 GB) with <iostream.h>and 
<iostream>. 

• Known limitations of exception handling features: 

— I nteroperability with setjmp/longjmp (undefined by the C-H-draft proposed 
international standard) is unimplemented. Executing longjmp does not cause 
any destructors to be run. 

— If an unhandled exception isthrown during program initialization phase (that is, 
before the main program begins execution) destructors for some constructed 
objects may not be run. 

— Symbolic debugging information is not always emitted for objects which are not 
directly referenced. For instance, if a pointer to an object is used but no fields are 
ever referenced, then H P aC-F-Fonly emits symbolic debug information for the 
poi nter type and not for the type of object that the poi nter poi nts to. For i nstance, 
use of Widget * only emits debug information for the pointer type 

Widget * and not for Widget. If you wish such information, you can create an 
extra source file which defines a dummy function that has a parameter of that 
type (Widget) and link it into the executable program. 

• Known limitations of signal handling features: 

— Throwing an exception in a signal handler is not supported, since a signal can 
occur anyplace, including optimized regions of code 

in which the values of destruct able objects are temporarily held in registers. 
Exception handling depends on destructableobjects being up-to-date in memory, 
but this condition is only guaranteed at call sites. 
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— Issuing a longjmp in a signal handler is not recommended for 
the same reason that throwing an exception is not supported. 

The signal handler interrupts processing of the code resulting 
in undefined data structures with unpredictable results. 

• Source-level debugging of C-H-shared libraries is supported. However, there are 
limitations related to debugging C-H-shared libraries, generally associated with 
classes whose member functions are declared in a shared library, and that have 
objects declared outside the shared library where the class is defined. Refer to the 
appropriate release notes and manuals for the operating system and debugger you 
are using. 

Refer also to the Software Status Bulletin for additional details. 

• Instantiation of shared objects with virtual functions in shared memory is not 
supported. 

• When you call the <shl_load>(3X) routines in libdid.sl either directly or indirectly (as 
when your application callsusetheTA option, you will see an "unresolved externals" 
error. 

If you want to link archive libraries and libdid.sl, use the-Wl,-a, archive option. The 
following example directs the linker to use the archive version of standard libraries 
and (by default) libdid.sl. 

aCC prog.o -Wl,-a,archive 

• Using shl_load(3X) with Library-Level Versioning 

Once library-level versioning is used, calls to shl_load() (seeshl_load(3X)) should 
specify the actual version of the library that is to be loaded. For example, if libA.sl is 
now a symbolic link to libA.l, then calls to dynamically load this library should 
specify the latest version available when the application is compiled, such as: 

shl_load("libA.1", BIND_DEFERRED, 0); 

This will insurethat, when the application is migrated to a system that has a later 
version of libA available, the actual version desired isthe one that is dynamically 
loaded. 

• Memory Allocation Routine allocaO 

The compiler supports the built in function, alloca, defined in the 
/usr/include/alloca.h header file. The implementation of the allocaO routine is system 
dependent, and its use is not encouraged. 

allocaO is a memory allocation routine similar to mallocO (see malloc(3C)). The 
syntax is: 

void ’^alloca (size_t <size>) ; 

allocaO allocates space from the stack of the caller for a block of at least <size> bytes, 
but does not initialize the space. The space is automatically freed when the cal ling 
routine exits. 


NOTE Memory returned by allocaO is not related to memory allocated by other memory 

allocation functions. Behavior of addresses returned by allocaO as parameters to 
other memory functions is undefined. 


To use this function, you must use the <alloca.h> header file. 
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